Data Browser

The main UI element in the sample application is the list box which is based on the deprecated List Manager. This step replaces that with the Data Browser control. The drawing code is largely unchanged from the custom list drawing procedure. Drawing a fill style highlight in a custom Data Browser column is actually tricky because the callback only passes in the content part bounds.

pascal void DrawIconDataBrowserItemCB(ControlRef browser, DataBrowserItemID item, 
                                        DataBrowserPropertyID property, 
                                        DataBrowserItemState itemState, const Rect *theRect, 
                                        SInt16 gdDepth, Boolean colorDevice)
{
#pragma unused (theRect)
    Rect enclosingRect, iconRect, textRect;
    Boolean active;
    IconDBItemDataRec *itemData;
    
    GetDataBrowserItemPartBounds(browser, item, property, kDataBrowserPropertyEnclosingPart, 
                                    &enclosingRect);
    
    active = IsControlActive(browser);
    
    if ((itemState & kDataBrowserItemIsSelected) != 0)
    {
        ThemeDrawingState savedState;
        
        GetThemeDrawingState(&savedState);
        
        SetThemePen(active ? kThemeBrushPrimaryHighlightColor : kThemeBrushSecondaryHighlightColor, 
                    gdDepth, colorDevice);
        PaintRect(&enclosingRect);
        
        SetThemeDrawingState(savedState, true);
    }
    
    calculateDrawingBounds(&enclosingRect, &iconRect, &textRect);    // get the drawing Rects
    itemData = (IconDBItemDataRec *)item;
    
    PlotIconRef(&iconRect, kAlignNone, active ? kTransformNone : kTransformDisabled, 
                kIconServicesNormalUsageFlag, itemData->icon);
    DrawThemeTextBox(itemData->name, kThemeViewsFont, 
                        active ? kThemeStateActive : kThemeStateInactive, true, &textRect, 
                        teCenter, NULL);
}

Another useful data browser callback is one that informs of selection changes. This step takes advantage of that callback to handle the panel switching.

pascal void IconDataBrowserItemSelectionCB(ControlRef browser, DataBrowserItemID item, 
                                            DataBrowserItemNotification message)
{
#pragma unused (browser)
    IconDBItemDataRec *itemData;
    
    itemData = (IconDBItemDataRec *)item;
    
    switch (message)
    {
        case kDataBrowserItemSelected:
            SetControlVisibility(itemData->userPane, true, true);    // this will draw over the 
            break;                                                // previously selected user pane
        
        case kDataBrowserItemDeselected:
            SetControlVisibility(itemData->userPane, false, false);        // we've already been 
            break;    // drawn over so there's no need to update the display (which would flicker)
    }
}

This was a good time to improve the localization and bundle support in the sample application. All displayed strings moved out of string resources and into strings files, and icons are moved out of icon resources and into icon files. Both file types are read in using Bundle Services, and the remaining resources are localized. See IconDBUtilities.c in 5_Data_Browser to see how the application loads in its resources. The window's Carbon event handler is also greatly simplified, see PrefsWindow.c.

Tutorial: Updating a Classic application to modern Carbon

5. The Data Browser Control